home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / program / slix0987.zip / SLIX.DOC < prev    next >
Text File  |  1996-08-10  |  22KB  |  679 lines
  1. .--------------------------------------------------------------.
  2. |                         .------------.                       |
  3. |                         | slix 0.987 |                       |
  4. |                         `------------'                       |
  5. |                                                              |
  6. |                  sprite library for mode x                   |
  7. |                  (and other tweaked modes)                   |
  8. |              Full QuickBASIC source code included            |
  9. |                                                              |
  10. |                     Written by Lloyd Chang                   |
  11. |                         August 10, 1996                      |
  12. |                                                              |
  13. |                  FREEWARE, NOT PUBLIC DOMAIN!                |
  14. |                                                              |
  15. `--------------------------------------------------------------'
  16.  
  17.    #########################################################
  18.    # DISCLAIMER: USE slix AT YOUR OWN RISK!                #
  19.    #             The author is not liable for any problems #
  20.    #             that may result from the use of slix.     #
  21.    #                                                       #
  22.    #########################################################
  23.  
  24. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  25. % slix is FREEWARE.  The program may be freely distributed    %
  26. % under the condition that the author be given credit for     %
  27. % slix.  Modifications are encouraged.                        %
  28. % Feel free to contact me if modifications are made to any    %
  29. % part of slix.                                               %
  30. %                                                             %
  31. % There are currently no other restrictions with regard to    %
  32. % the use of slix.                                            %
  33. %                                                             %
  34. %     **************************************************      %
  35. %     * PLEASE READ THE DISCLAIMER BEFORE YOU USE slix *      %
  36. %     **************************************************      %
  37. %                                                             %
  38. % I can be reached via:                                       %
  39. %                                                             %
  40. % Internet: lloyd.chang@tglbbs.com (!!The Game Line!!)        %
  41. %  Fidonet: Lloyd Chang [1:278/304] (BlueDog)                 %
  42. %                                                             %
  43. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  44.  
  45. ----------------------------------------------------------------
  46.  
  47. Some people to thank...(in alphabetical order)
  48.  
  49. Michael Abrash -- For documenting Mode X in Dr. Dobb's Journal
  50.                   [mabrash@bix.com]
  51.                   [mabrash@mcimail.com]
  52.  
  53. Phil Carlisle -- Mode X FAQ
  54.                  [pc@espr.demon.co.uk]
  55.  
  56. Carl Gorringe -- For showing interest in slix
  57.  
  58. Rich Geldreich -- Original GIF-displaying code
  59.  
  60. Themie Gouthas -- XLIB
  61.                   [egg@dstos3.dsto.gov.au]
  62.                   [teg@bart.dsto.gov.au]
  63.  
  64. Petri Hassinen -- Game Making Utilities
  65.                   [phassine@alpha.hut.fi]
  66.  
  67. Petri Hodju -- Game Making Utilities
  68.  
  69. Saku Jalkanen -- Game Making Utilities (GRAPHICS)
  70.  
  71. Christopher G. Mann -- ASPHYXIA VGA trainer series
  72. (a.k.a. Snowman)       [r3cgm@dax.cc.uakron.edu]
  73.  
  74. Robert Schmidt -- XINTRO & Tweak
  75. (a.k.a. Buuud)    [robert@stud.unit.no]
  76.  
  77. Dave Shea -- For showing interest in slix
  78.  
  79. Grant Smith      -- ASPHYXIA VGA trainer series
  80. (a.k.a. Denthor)    [smith9@batis.bis.und.ac.za]
  81.  
  82. Nikolai Soumarokov -- GNOOM II
  83.  
  84. Mike Valley -- Retrieving Mode X related info
  85.                Numerous programming tips
  86.  
  87. [zabudsk@ecf.utoronto.ca] -- Original BMP-displaying code
  88. (Sorry, I should have contacted you for your real name)
  89.  
  90. Others -- Sorry if your name was not listed...
  91.           Anyway, thanks!
  92.  
  93. (I hope everyone's name was spelled correctly.)
  94.  
  95. If anyone above wish to have their internet e-mail address(es)
  96. listed in this document, please contact me.
  97.  
  98. Also, please contact me if I forgot to
  99. include someone's name in the above list.
  100.  
  101. ---------------------------------------------------------------
  102.  
  103. slix contains two other FREEWARE packages.
  104. They are GNOOM II & Game Making Utilities.  GNOOM II may be used to
  105. create GN2 files.  Game Making Utilities is included as a token of thanks
  106. for the use of GMU images in slix.  I have not yet made any contacts
  107. with either authors of GNOOM II or GMU.  Hopefully, Nikolai Soumarokov
  108. and Petri Hassinen, respectively, will not be offended by the inclusion
  109. of their programs.
  110.  
  111. ----------------------------------------------------------------
  112.  
  113.                  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
  114.                  $$                          $$
  115.                  $$ COMPILING SPEEDS UP slix $$
  116.                  $$                          $$
  117.                  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
  118.  
  119.  
  120. .---------------------------.
  121. | BUGS, BUGS, and more BUGS |
  122. `---------------------------'
  123.  
  124. slix is TOO SLOW!!!  Optimizations are needed.
  125.   The best bet would be to link in ASSEMBLY code from XLIB.
  126.   (Someone would have to write "DECLARE ..." for each XLIB routine)
  127.   If that occurs, the development of slix may stop.
  128.  
  129. INKEY$ should be replaced with a better key-retrieving function.
  130.   I am thinking of writing a function named "KEYIN$" by using
  131.   PEEKs.  Hopefully, Multiple-key presses (ctrl+key1, shift+key1,
  132.   alt+key1, & KEY1+KEY2+KEY3) will be supported.  I have yet seen
  133.   a QuickBASIC routine that supports KEY1+KEY2+KEY3.  However,
  134.   key-combos retrieval should be possible by manipulating the
  135.   keyboard buffer.
  136.  
  137. Virtual scrolling, background scrolling, & split-screen
  138. routines have not been written for slix.
  139.   There are plenty of ASM/C sources available to
  140.   port to QuickBASIC.
  141.  
  142. Collision tests have not been written.
  143.  
  144. 3D animation have not been written either.
  145.   I would recommend people to convert ASM/C code
  146.   from Michael Abrash's XSHARP pacakge.
  147.  
  148. There is only a 5x5 font available.  It is possible to
  149. use fonts from DOS (8x8, 8x14, 8x16) via interrupts.
  150.   There are QuickBASIC code available to do this but
  151.   I have not yet implemented them.
  152.  
  153. 24-bit BMP files are not be displayed properly.
  154.   (The red and blue color bits are reversed)
  155.  
  156. When displaying images that are greater than the screen size,
  157. the FILEX parameter "UseZero%" may to be set to 1.
  158.   (For example, FILEX "filename.ext", 0, 0, 1, 0)
  159.  
  160. A GIF/BMP to HR8 FILE CONVERTER HAS BEEN WRITTEN.
  161.   The source code is within the file "2HR8.BAS"
  162.   Currently, I have not written a program to convert
  163.   a HR8 file back to a GIF/BMP file.
  164.  
  165. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  166. !!                                                     !!
  167. !! slix displays HR8s MUCH FASTER than GIFs and BMPs   !!
  168. !! (see note above about the GIF/BMP to HR8 converter) !!
  169. !!                                                     !!
  170. !!                                                     !!
  171. !! The GIF-displaying routine is somewhat slow         !!
  172. !!                                                     !!
  173. !! The BMP-displaying routine is REALLY slow           !!
  174. !!                                                     !!
  175. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  176.  
  177. &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
  178. &                                                              &
  179. &  The "DEFAULT.PAL" file in GN2-SLIX.ZIP needs to be used in  &
  180. &  place of the GNOOM II "DEFAULT.PAL" to create sprites with  &
  181. &  colors that correspond to the palette in "RGB.PAL"          &
  182. &                                                              &
  183. &  In otherwords, replace the "DEFAULT.PAL" in GN2V102.ZIP     &
  184. &  with the "DEFAULT.PAL" in GN2-SLIX.ZIP                      &
  185. &                                                              &
  186. &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
  187.  
  188.  
  189. |~~~~~~~~~~~~~|
  190. | Q&A Sessio